home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d21 / qw12.exe / QWHITE12.EXE / APISTART.TEC < prev    next >
Text File  |  1990-08-30  |  3KB  |  70 lines
  1. ID:AP Starting DESQview Under API
  2. Quarterdeck Technical Note
  3. by Stan Young
  4.  
  5.           Starting DESQview Under API Program Control
  6.  
  7.    Many API programs are designed to run in much the same as any
  8. off-the-shelf program in the DESQview environment.  That is, the user
  9. simply selects the program from the Open Window menu, it opens and once
  10. running can begin to control and take advantage of DESQview.
  11.  
  12.    Creating an "auto-start" macro for DESQview can allow the program to be
  13. brought up automatically on the start of DESQview.  The "auto-start" macro
  14. is described in the DESQview users' manual (page 89 in the Version 2
  15. manual).  The auto-start macro can be used to start either API or standard
  16. applications automatically when starting DESQview.
  17.  
  18.    An auto-start macro is generally a good starting method when you want to
  19. make sure your API program is run, but want to make most of the features of
  20. DESQview available to your users.  The default for starting using this
  21. method is that all of the standard menu items of DESQview are enabled. Your
  22. API program has to specifically disable menu selections after starting up
  23. if you do not want all of them available. However, sometimes API developers
  24. will want their programs to control the system more fully.  To accomplish
  25. this, you can start DESQview as follows:
  26.  
  27. DV {program information filename}
  28.  
  29. An example of a program started in this fashion is on every users DESQview
  30. disk in the SETUP.BAT file.  It reads as follows:
  31.  
  32. DV SETUP.DVP {additional parameters}
  33.  
  34.    The additional parameters listed in SETUP.BAT are specific to DESQview
  35. operation, and would not normally become a part of your API program startup
  36. (/OK assumes "non-enhanced keyboard," /NS means don't read the setup file,
  37. use defaults).
  38.  
  39.    Run the DESQview Setup and you will get an idea of the defaults under
  40. which API programs started from the command line are run:
  41.  
  42.      1.  After display of the DESQview copyright screen, the 
  43.      application listed in the DVP file is automatically run.
  44.  
  45.      2.  All access to the DESQview menu is disabled.  DESQview 
  46.      macros, including the auto-start macro for the window, are 
  47.      enabled if present, but access to the Learn menu is not 
  48.      available.
  49.  
  50.      3.  Terminating the application terminates DESQview and 
  51.      drops you out to the DOS prompt.
  52.  
  53.    Obviously, the DESQview Setup program is a limited, single-tasking
  54. environment, but it demonstrates that an API program program started from
  55. the command line is firmly in control.  Once started, the API program can
  56. start additional tasks (NEW or NEWPROC in assembler, app_new or app_start
  57. in C or Pascal), and selectively enable the features of DESQview (Manager
  58. streams 00 to 3F in Assembler, or win_allow function in C or Pascal).
  59.  
  60.    The only feature which cannot be enabled is the Open Window item. When
  61. an API program is started from the command line, the DESQVIEW.DVO file,
  62. which contains the Open Window menu information, is not read into memory
  63. and the Open Window option will not be available.  Your API program could
  64. of course produce its own "front end" menu of programs to open if you like.
  65. If you want to allow users to have access to the Open Window menu, you
  66. would want to start up using the auto-start macro.
  67.  
  68.         Copyright (C) 1990 by Quarterdeck Office Systems
  69.              * * *   E N D   O F   F I L E    * * * 
  70.